home *** CD-ROM | disk | FTP | other *** search
/ Nebula 1 / Nebula One.iso / Communications / pcomm / Source / pcomm.out < prev    next >
Encoding:
Text File  |  1995-06-12  |  9.6 KB  |  331 lines
  1.  
  2.  
  3.  
  4.      PCOMM(1)           UNIX    System V (local)          PCOMM(1)
  5.  
  6.  
  7.  
  8.      NAME
  9.       pcomm    - a telecommunication program
  10.  
  11.      SYNOPSIS
  12.       pcomm    [ -d directory ] [ -f system name ]
  13.  
  14.      DESCRIPTION
  15.       Pcomm    is a public domain telecommunication program for Unix
  16.       that is designed to operate similar to the MSDOS program,
  17.       ProComm.  ProComm (TM) is copyrighted    by Datastorm
  18.       Technologies,    Inc.
  19.  
  20.       The -d option    is used    to specify an additional path to
  21.       search for the Pcomm support files.
  22.  
  23.       The -f option    is used    to specify automatic dialing of    an
  24.       entry    in the dialing directory.  The name field in the
  25.       dialing directory is checked against the string given    on the
  26.       command line.     If a match is found, that entry is
  27.       automatically    dialed.
  28.  
  29.       Whenever Pcomm is in the command mode, a status line is
  30.       displayed at the bottom of the screen.  The eight fields of
  31.       the status line are:
  32.  
  33.            o help screen command (or a temporary message)
  34.            o name of the TTY device    in use
  35.            o duplex    mode (FDX = full duplex, HDX = half duplex)
  36.            o current line settings
  37.            o status    of data    logging    option
  38.            o status    of printer logging option
  39.            o incoming CR translation
  40.            o outgoing CR translation
  41.  
  42.      COMMANDS
  43.       The following    commands are accessible    by pressing a user
  44.       definable "hot key" followed by a letter, number, or arrow
  45.       key.    The default "hot key" is control-A.  The notation
  46.       "^A-X" means control-A followed by the letter    X. The dash
  47.       (-) is for clarity, and is not a part    of the command
  48.       sequence.
  49.  
  50.       ^A-0 Help Screen.  Display a brief review of the available
  51.            commands.  Uses the number zero "0" not the letter "O".
  52.  
  53.       ^A-D Dialing Directory.  The dialing directory screen    is
  54.            used to display and maintain the    database of phone
  55.            number entries, and to select an    entry for dialing.  To
  56.            dial an entry, just enter the entry number at the
  57.            prompt.    If the "script"    field contains valid Unix
  58.            shell script, that file is used to automatically    log
  59.            the user    on to the remote system.  See the Pcomm
  60.  
  61.  
  62.  
  63.      Page 1                        (printed 12/31/89)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      PCOMM(1)           UNIX    System V (local)          PCOMM(1)
  71.  
  72.  
  73.  
  74.            Reference Manual    for the    format and use of the script
  75.            files.  The following commands are available from the
  76.            dialing directory:
  77.  
  78.            R    Revise (or add) a dialing directory    entry or a
  79.             long distance dialing code.
  80.  
  81.            P    Print (display) the    long distance dialing codes.
  82.  
  83.            up/down
  84.             Scroll the dialing directory up or down 10 lines.
  85.             Uses the up    and down arrow keys.
  86.  
  87.            M    Manual dial.  Prompts for a    phone number rather
  88.             than using a number    already    in the dialing
  89.             directory.
  90.  
  91.            D    Delete an entry or a range of entries.
  92.  
  93.            L    Print.  Send the dialing directory to the printer
  94.             or a file of your choice.
  95.  
  96.       ^A-R Automatic redial    of selected dialing directory entries.
  97.            Prompts the user    for a list of directory    entries    to be
  98.            placed in the queue.  Pcomm will    dial the numbers in a
  99.            cycle until one of them answers.
  100.  
  101.       ^A-M Allows the user to maintain a list of keyboard macros
  102.            assigned    to the shifted number keys.  When pressed, the
  103.            string assigned to that key is sent to the remote
  104.            system.
  105.  
  106.       ^A-P Adjust the current communication    line settings.
  107.            Display a menu of baud rate, parity, data bit, and stop
  108.            bit choices.  Allows the    new choice to be saved and
  109.            become the default.  After dialing a remote, the    line
  110.            settings    in the dialing directory entry are
  111.            automatically used.  The    current    line settings are
  112.            shown in    the status line.
  113.  
  114.       ^A-X Exit from Pcomm.
  115.  
  116.       ^A-4 Spawn a Unix shell while    still communicating with the
  117.            remote system.  Uses the    "native" shell as described in
  118.            the SHELL environmental variable.
  119.  
  120.       ^A-I Display the program information screen.
  121.  
  122.       ^A-S Display a choice    of setup screens.  The following sub-
  123.            menus are available:
  124.  
  125.            1    TTY    Setup.    This setup assigns the TTY ports that
  126.  
  127.  
  128.  
  129.      Page 2                        (printed 12/31/89)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      PCOMM(1)           UNIX    System V (local)          PCOMM(1)
  137.  
  138.  
  139.  
  140.             Pcomm is allowed to    use, and what is attached to
  141.             each port.
  142.  
  143.            2    Modem Setup.  The modem setup contains the
  144.             commands to    make the modem dial, hang up the
  145.             phone, etc.
  146.  
  147.            3    Terminal Setup.  The terminal setup    contains the
  148.             definition of the "hot key"    and the    mapping    of the
  149.             end-of-line    characters.
  150.  
  151.            4    General Setup.  The    general    setup contains the
  152.             default log    file name, and the set of character
  153.             synonyms.
  154.  
  155.            5    ASCII Transfer Setup.  This    setup screen contains
  156.             additional character translations allowed during
  157.             ASCII file transfers.
  158.  
  159.            6    External Protocol Setup.  This setup screen    allows
  160.             the    user to    embed the names    of external file
  161.             transfer programs into the list of available
  162.             protocols.
  163.  
  164.            S    Save the changes to    disk.
  165.  
  166.       ^A-B Change the current working directory.
  167.  
  168.       ^A-C Clear the local screen and home the cursor.
  169.  
  170.       ^A-E Toggle the duplex mode from full    to half, or from half
  171.            to full.     The status line shows the current duplex
  172.            mode.
  173.  
  174.       ^A-H Hang up the phone.  Disconnect the phone, but remain in
  175.            Pcomm.
  176.  
  177.       ^A-L Toggle the printer on and off.  Since the printer is
  178.            accessed    through    the normal Unix    spool program, the
  179.            output is not sent to the printer until after this
  180.            feature is turned off.
  181.  
  182.       ^A-3 Toggle the incoming line    termination characters between
  183.            the carriage return and the carriage return line    feed
  184.            pair.  This affects the terminal    session    only, not the
  185.            file transfers.    The current settings are shown in the
  186.            status line.
  187.  
  188.       ^A-7 Send a modem break.  This is not    the same as the    break
  189.            key on the keyboard.
  190.  
  191.       ^A-up
  192.  
  193.  
  194.  
  195.      Page 3                        (printed 12/31/89)
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.      PCOMM(1)           UNIX    System V (local)          PCOMM(1)
  203.  
  204.  
  205.  
  206.            Display a menu of file transfer protocols to be used to
  207.            send files to a remote system.  Uses the    up arrow key.
  208.  
  209.       ^A-down
  210.            Display file transfer protocols to be used to receive
  211.            files from a remote system.  Uses the down arrow    key.
  212.  
  213.       ^A-F Display the contents of a Unix directory.
  214.  
  215.       ^A-G Dump the    contents of the    screen to a specified file.
  216.            Special graphics    characters may not be represented
  217.            accurately in the file.
  218.  
  219.       ^A-1 Begin data logging.  Prompts the    user for the name of
  220.            the file    that will be used to collect a complete    record
  221.            of the terminal session.
  222.  
  223.       ^A-2 Toggle the data logging option without prompting    for a
  224.            new file    name.  The status line shows the current data
  225.            logging mode.
  226.  
  227.      FILE TRANSFERS
  228.       Pcomm    understands the    following file transfer    protocols:
  229.  
  230.            protocol        packet     error          multiple
  231.            name        size       method          files?
  232.            _______________________________________________
  233.            xmodem        128           checksum/CRC   no
  234.            xmodem-1k    128/1024   checksum/CRC   no
  235.            modem7        128           checksum          yes
  236.            ymodem        128/1024   CRC          yes
  237.            ymodem-g        128/1024   none          yes
  238.            ASCII        none       none          no
  239.            zmodem        128/1024   CRC          yes
  240.            (external)   ?           ?          ?
  241.  
  242.       Pcomm    can use    an external program, such as Kermit or a
  243.       proprietary program, to transfer files.  Commonly used
  244.       external programs (such as zmodem in the example above) can
  245.       have their names embedded into the list of available
  246.       protocols.
  247.  
  248.      CONFIGURATION
  249.       Pcomm    must have access to the    terminfo or termcap data for
  250.       the terminal being used.  The    minimum    capabilities include a
  251.       screen size of at least 80 columns by    24 lines and cursor
  252.       movement capabilities.  Running Pcomm    from terminals at
  253.       relatively slow speeds (i.e. 1200 baud) will cause the
  254.       windows to appear sluggish.
  255.  
  256.       Terminals that don't have arrow keys or systems without the
  257.       newer    versions of curses(3) will require the user to
  258.  
  259.  
  260.  
  261.      Page 4                        (printed 12/31/89)
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.      PCOMM(1)           UNIX    System V (local)          PCOMM(1)
  269.  
  270.  
  271.  
  272.       substitute the letter    "U" for    "up arrow" and "N" for "down
  273.       arrow".
  274.  
  275.       There    are four Pcomm support files that contain the dialing
  276.       directory, the external file transfer    programs, the
  277.       modem/TTY database, and the start-up default parameters.
  278.       Users    may maintain private versions of these files in    a
  279.       directory of their choice.  Pcomm also uses normal Unix
  280.       shell    scripts    to perform the "chat" sequences    necessary to
  281.       automatically    log a user onto    a remote system.  Pcomm    uses
  282.       the environmental variable PCOMM to search for the "private"
  283.       support file and the auto-login shell    scripts.  The
  284.       following directories    are searched to    find the files:
  285.  
  286.            o directory given with the -d option
  287.            o directory in the PCOMM    environmental variable
  288.            o current directory
  289.            o default directory (compiled into Pcomm)
  290.  
  291.       The "script" field in    the dialing directory serves two
  292.       purposes.  The first use is to identify the shell script to
  293.       use for auto-login.  The second use is to specify a TTY name
  294.       for a    given entry.  If the "script" is a valid device    name,
  295.       that device is used instead of searching the TTY database
  296.       for a    free port.
  297.  
  298.      FILES
  299.       pcomm.dial_dir   the dialing directory
  300.       pcomm.extrnl       the external    file transfer programs
  301.       pcomm.modem       the modem/TTY database
  302.       pcomm.param       the start-up    default    parameters
  303.  
  304.      SEE ALSO
  305.       Pcomm    Reference Manual, xmodem(1), mdm(1)
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.      Page 5                        (printed 12/31/89)
  328.  
  329.  
  330.  
  331.